Syntax
public static void PaintRegionBuffer(
RasterImage image,
Graphics graphics,
LeadRect srcRect,
LeadRect srcClipRect,
LeadRect destRect,
LeadRect destClipRect,
byte[] buffer,
int bufferOffset,
int row,
int count,
RasterPaintProperties properties
)
Public Overloads Shared Sub PaintRegionBuffer( _
ByVal image As Leadtools.RasterImage, _
ByVal graphics As Graphics, _
ByVal srcRect As Leadtools.LeadRect, _
ByVal srcClipRect As Leadtools.LeadRect, _
ByVal destRect As Leadtools.LeadRect, _
ByVal destClipRect As Leadtools.LeadRect, _
ByVal buffer() As Byte, _
ByVal bufferOffset As Integer, _
ByVal row As Integer, _
ByVal count As Integer, _
ByVal properties As Leadtools.Drawing.RasterPaintProperties _
)
public:
static void PaintRegionBuffer(
Leadtools.RasterImage^ image,
Graphics^ graphics,
Leadtools.LeadRect srcRect,
Leadtools.LeadRect srcClipRect,
Leadtools.LeadRect destRect,
Leadtools.LeadRect destClipRect,
array<byte>^ buffer,
int bufferOffset,
int row,
int count,
Leadtools.Drawing.RasterPaintProperties properties
)
Parameters
graphics
The destination System.Drawing.Graphics object where the image data will be displayed.
srcRect
A Leadtools.LeadRect object that specifies the part of the image to use as the display source.
The coordinates in the srcRect rectangle are relative to the image. You can pass Rectangle.Empty to use the default, which matches the image.
srcClipRect
A Leadtools.LeadRect object specifies the portion of the display source to paint. Generally, this is used for updating the display when part of the source image has changed.
The coordinates in the srcClipRect rectangle are relative to the image. You can pass Rectangle.Empty to use the default, which matches the image
destRect
A Leadtools.LeadRect object that determines how the source rectangle is scaled and how the image is positioned in the destination graphics object.
The coordinates in the destRect object are relative to the graphics object. There is no default for this parameter. You must specify the Leadtools.LeadRect object.
destClipRect
A Leadtools.LeadRect object that specifies the portion of the display rectangle to paint. Generally, this is used for updating changes in the display surface, such as when a user moves another window, uncovering a part of the image that had been covered up.
The coordinates in the destClipRect are relative to the System.Drawing.Graphics object. You can pass Rectangle.Empty to use the default, which matches the System.Drawing.Graphics object. In most cases, however, you should use the rectangle returned by the .NET PaintEventArgs.ClipRectangle or Windows WM_PAINT message.
buffer
The buffer that contains the image data to paint
bufferOffset
Offset into buffer where the data starts.
row
The first row to paint. The painted portion of any row may be limited by the rectangle parameters.
count
The number of rows to paint. The painted portion of any row may be limited by the rectangle parameters.
If the image data in buffer is compressed 1-bit data, you can specify the number of lines as a negative value (-lines
), as explained in Speeding Up 1-Bit Documents.
properties
Options for the display.
Example
using Leadtools;
using Leadtools.Codecs;
using Leadtools.Drawing;
using Leadtools.ImageProcessing;
public void PaintRegionBufferExample()
{
PaintRegionBufferForm f = new PaintRegionBufferForm();
f.ShowDialog();
}
class PaintRegionBufferForm : Form
{
private RasterImage image;
public PaintRegionBufferForm()
{
// Load the image
RasterCodecs codecs = new RasterCodecs();
string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp");
image = codecs.Load(srcFileName);
// add a region to the image
image.AddEllipseToRegion(
RasterRegionXForm.Default,
new LeadRect(image.Width / 4, image.Height / 4, image.Width / 2, image.Height / 2),
RasterRegionCombineMode.Set);
Text = "PaintRegionBuffer Example";
}
protected override void Dispose(bool disposing)
{
// Clean up
if (disposing)
{
image.Dispose();
}
base.Dispose(disposing);
}
protected override void OnPaint(PaintEventArgs e)
{
// Draw the image fit and center on this form
LeadRect destRect = LeadRect.FromLTRB(ClientRectangle.Left, ClientRectangle.Top, ClientRectangle.Right, ClientRectangle.Bottom);
destRect = RasterImage.CalculatePaintModeRectangle(
image.ImageWidth,
image.ImageHeight,
destRect,
RasterPaintSizeMode.Fit,
RasterPaintAlignMode.Center,
RasterPaintAlignMode.Center);
byte[] buffer = new byte[image.BytesPerLine];
image.Access();
for (int row = 0; row < image.Height; row++)
{
image.GetRow(row, buffer, 0, image.BytesPerLine);
RasterImagePainter.PaintRegionBuffer(image, e.Graphics, LeadRect.Empty, LeadRect.Empty, destRect, LeadRect.Empty, buffer, 0, row, 1, RasterPaintProperties.Default);
Thread.Sleep(20);
}
image.Release();
base.OnPaint(e);
}
}
static class LEAD_VARS
{
public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
}
Imports Leadtools
Imports Leadtools.Codecs
Imports Leadtools.Drawing
Imports Leadtools.ImageProcessing
Public Sub PaintRegionBufferExample()
Dim f As New PaintRegionBufferForm()
f.ShowDialog()
End Sub
Class PaintRegionBufferForm
Inherits Form
Private image As RasterImage
Public Sub New()
' Load the image
Dim codecs As New RasterCodecs()
Dim srcFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp")
image = codecs.Load(srcFileName)
' add a region to the image
image.AddEllipseToRegion(
RasterRegionXForm.Default,
New LeadRect(image.Width \ 4, image.Height \ 4, image.Width \ 2, image.Height \ 2),
RasterRegionCombineMode.Set)
Text = "PaintRegionBuffer Example"
End Sub
Protected Overrides Sub Dispose(ByVal disposing As Boolean)
' Clean up
If disposing Then
image.Dispose()
End If
MyBase.Dispose(disposing)
End Sub
Protected Overrides Sub OnPaint(ByVal e As PaintEventArgs)
' Draw the image fit and center on this form
Dim destRect As LeadRect = LeadRect.FromLTRB(ClientRectangle.Left, ClientRectangle.Top, ClientRectangle.Right, ClientRectangle.Bottom)
destRect = RasterImage.CalculatePaintModeRectangle(
image.ImageWidth,
image.ImageHeight,
destRect,
RasterPaintSizeMode.Fit,
RasterPaintAlignMode.Center,
RasterPaintAlignMode.Center)
Dim buffer(image.BytesPerLine - 1) As Byte
image.Access()
For row As Integer = 0 To image.Height - 1
image.GetRow(row, buffer, 0, image.BytesPerLine)
RasterImagePainter.PaintRegionBuffer(image, e.Graphics, LeadRect.Empty, LeadRect.Empty, destRect, LeadRect.Empty, buffer, 0, row, 1, RasterPaintProperties.Default)
Thread.Sleep(20)
Next
image.Release()
MyBase.OnPaint(e)
End Sub
End Class
Public NotInheritable Class LEAD_VARS
Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class